docs(guide): state the html tier's tag spelling on react-pages, scope the react tier's - #7939

Fixes #7006

content/docs/guide/react-pages.md is the home for both source-authoring tiers, but the only tag-naming rule it stated was the react tier's PascalCase one. A kind:'html' author who followed the stated rule was rejected at save time, with nothing on the page naming the rule they broke — while the page's own html examples already demonstrated the correct spelling.

Prose only. No parser, manifest or authorable-surface change: the rule already is what this page now says, the page was simply silent about it. Modelled on the same fix upstream (objectstack-ai/objectstack#13734), which repairs this defect on content/docs/ui/react-pages.mdx.

(Tag names below are written without their angle brackets — the platform's body sanitizer eats short angle-bracket fragments.)

The rule, re-measured (not taken from the card)

Re-read on the objectstack checkout at a4816a7:

• packages/sdui-parser/src/index.ts:41 — const allowedTags = new Set(Object.keys(manifest.components));
• packages/sdui-parser/src/parse.ts:95 — if (this.opts.allowedTags && !this.opts.allowedTags.has(tag)) {, error is not an allowed component

An exact Set.has against the manifest's own keys. grep -nE 'toLowerCase|toUpperCase|localeCompare' over packages/sdui-parser/src/ hits only codegen.ts (which derives the react tier's PascalCase names) — nothing on the whitelist path. The card's premise holds.

Registry figures re-measured independently in this repo, from packages/core/src/registry/public-blocks.ts: 57 entries, 28 carrying a namespace prefix, 4 snake_case after the colon (record:related_list, record:line_items, record:quick_actions, record:reference_rail) — matching the card's numbers exactly.

Edit 1 — the kind:'html' section now states the spelling

Unchanged sentence above it: "Only tags in the public block manifest are allowed, props are validated against each block's declared inputs, and unknown tags are a hard error at save time."

Added after it:

Those tags are the registered type names, written verbatim — whatever the registry spells, character for character, including a record: / page: / element: / action: namespace prefix and any underscore inside the name: list-view, object-form, record:related_list, record:quick_actions. The whitelist is an exact string comparison, so nothing is normalised for you: the PascalCase tags this page shows for kind:'react' are the other tier's convention and are not registered names (ListView is rejected with ListView is not an allowed component), and neither is a name re-spelled to look uniform — record:related-list is not registered, only record:related_list is.

The wording deliberately says "the registered type name, verbatim" and never "kebab-case". "kebab-case" would send an author to record:related-list, which is not registered either — so the paragraph names that wrong spelling explicitly and rules it out. The upstream model PR does use the phrase "lowercase and kebab-case"; that half of its wording is not copied here.

Edit 2 — the react-tier naming passages are scoped

Before (scope table row):

| The public data blocks | Every public non-container block, as a PascalCase tag — but what resolves and what you author against are two different sets, below. |

After:

| The public data blocks | Every public non-container block, as a PascalCase tag on this tier — but what resolves and what you author against are two different sets, below. |

Before (tag derivation):

Tags are derived by splitting the registry type on -, _ and : and PascalCasing each part: object-grid → ObjectGrid, record:details → RecordDetails.

After:

On this tier tags are derived by splitting the registry type on -, _ and : and PascalCasing each part: object-grid → ObjectGrid, record:details → RecordDetails. A kind:'html' page writes the registry type itself instead — object-grid, record:details.

The section names kind:'html' at seven places; only the section itself gained the rule.

Reverse verification — anchor counts (grep -c, on the page)

Gates (redirect-then-capture; each gate's own verdict line)

Run at 7686d3c80, worktree base b8e3f8379.

check:doc-snippets was run for real, not narrowed: its --build-filter closure (34 tasks) was built first under the shared verify lock, so its exit 0 is a verdict about documents rather than an exit 2 "could not run".

Extra control-byte sweep beyond the gate: grep -naP '[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]' over the edited file — no hits.

Files changed

content/docs/guide/react-pages.md — 1 file, +18 / −5. No changeset (the gate above says none is owed: a docs page under content/docs releases nothing).

Generated by Claude Code